.. _cmlPmStGetSpeed:

cmlPmStGetSpeed 
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

   VT_I4 cmlPmStGetSpeed ([in] VT_I4 BoardID,  [in] VT_I4 NodeId, [in] VT_I4 Channel, 
   [in] VT_I4 Source, [out] VT_PR8 Speed )                 

DESCRIPTION
`````````````  

- 이 함수는 Command 또는 Feedback 속도를 읽어서 논리적 속도 단위로 반환합니다. Source 매개 변수에 
  따라서 Command속도 혹은 Feedback속도 중 해당하는 속도에 대해서 반환 대상이 결정됩니다. 

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NodeId : 노드 번호. 노드 번호는 3부터 시작합니다. 
 
▶ Channel : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 최대 
통합 축 개수 - 1 이하의 값을 축 번호로 설정할 수 있습니다. 
 
▶ Source : 속도 반환 대상이 되는 카운터 번호. 이 값은 다음의 2가지 값 중의 하나이어야 합니다. 

.. csv-table::
  :widths: 10 90
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  0(cmlCNT_COMM), Command Counter
  1(cmlCNT_FEED), Feedback Counter


▶ Speed : 전달된 변수를 통해 지정한 카운터의 속도를 읽어서 논리적 속도 단위로 반환합니다.



RETURN VALUE
`````````````

.. csv-table::
  :widths: 10 90
  :header-rows: 1
  :stub-columns: 0

  Value, Meaning
  음수, 수행 실패
  ERR_NONE, 수행 성공

REFERENCE
`````````````

- 논리적 단위 거리는 cmlPmCfgSetUnitSpeed() 함수에 의해 결정됩니다.

EXAMPLE
```````````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    C/C++ 
    #include “ComiMLink2_SDK.h” 
    #include “ComiMLink2_SDK_Def.h” 
    long BoardID = 0; 
    long nCmdSpeed = 0; 
    long nFdbSpeed = 0; 
    //0번 축의 Command Speed값을 반환합니다. 
    cmlPmStGetSpeed(BoardID, 0, ccmlX1, cmlCNT_COMM, &nCmdSpeed ); 
    //0번 축의 Feedback Speed값을 반환합니다. 
    cmlPmStGetSpeed(BoardID, 0, ccmlX1, cmlCNT_FEED, &nFdbSpeed );